DuplicateODOSLToken

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODOSLToken

DuplicateODOSLToken
The DuplicateODOSLToken method copies all context information of this OpenDoc token and creates a new OpenDoc token that contains a reference to a descriptor object.
ODOSLToken DuplicateODOSLToken ();
return value
A reference to the new OpenDoc token.

DISCUSSION
You must call this method whenever you need to copy an OpenDoc token; it ensures that private data in this OpenDoc token gets copied correctly. You might use this method during object resolution when you are referring to a group of objects and you want to make OpenDoc tokens representing each object.
Although technically there is no factory method for the ODOSLToken class, the DuplicateODOSLToken method could be considered a factory method since it is really the only valid way for you to create a new OpenDoc token.

EXCEPTIONS

kODErrOutOfMemory
There is not enough memory to allocate the OpenDoc token.

SEE ALSO
Table 11-1 on page 466 in OpenDoc Programmer's Guide.